FIX Reference Manual 1«0 
By Michael Ekberg* 1/26/81 


I» INTRODUCTION TO FIX 


Fix is an assembla language utilita to exanin« and modifa 
disk filas» All numbers outputted ba and entered to FIX arc 
hexidecimal* The Ctrl 1 kea can be used to Start and stop tha 
data displaa on tha screen« 


II« FILE STRUCTURE 


Oiskattes ara divided into blocks of data called sactors» 
The ATARI 810 has 720 sactors of 128 bates* Tha ATARI .815 
has 720 sactors of 256 bates« Diskattas hava four parts! 


1« BIT MAP« Tha bit nap contains Information on tha 
Status of aach sactor« Ba examining tha Bit Map tha 
File Manager can determine if a sactor has baen 
allocated(in usa) or not(free)« 

2« DIRECTORY« Tha directora sactors contain 
information on tha nanes* location» length# and Status 
of tha filas on a diskette« 

3* BOOT SECTORS« Each diskatta contains 1 or 3 sactors 
rasarvad for Information read on power-up« These 
sactors ara normalla inaccassabla to tha usar when 
using tha File Manager« All 9/24/7? DOS diskettas usa 
sactors 1 for tha boot« All DOS II 2S or 2D diskettas 
usa sactors 1*2 and 3« 

4« DATA SECTORS« Tha rast of tha sactors ara usad to 
stora tha information in tha filas« Most of tha bates 
of a sactor ara dedicatad to tha actual fila 
information« Tha last thraa bates of evera sactor 
contains “house-keeping" information for tha File 
Manager « 

FILES ara mada up of a DIRECTORY ENTRY and a sat of ona 
ör more sactors« Tha sactors ara usualla contiguous but do 
not hava to ba« For a complate dascription of a directora 
antra sae saction III»A 
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III. MENU ITEMS 


FIX is a Menu driven progran* To execute connands» type 
the letter in front of the connand listed in the displayed 
nenuCsee Fig. D* 

You do not nead to type <RETURN>* FIX autonatically accepts 
your connand and replies with tha pronpt for that connand* If 
you have inadvertantly typed tha wrong connand. hit tha 
<BREAK> Key to abort the connand* 

A* Directory Entries* 


This nanu iten will display tha entries in tha directory* 
Fig«l shows tha user requesting FIX to display the first 
8(hex) entriss« Notice that tha entriss Start with 0* The 
directory nay contain a naxinun of 64 filas« Single entrdes 
nay be displayed by sinply typing tha fila nunbar and <RETURN>» 

Tha laft nost colunn givas tha fila nunber of aach fila 
displayed« The next colunn is tha filanana and extension* 
Notice that tha period is onittad in the fila nana* The next 
colunn. labelled FSEC. is tha first sactor in tha fila* The 
#SEC colunn givas tha nunbar of sactors in the fila* Both 
nunbars are haxadacinal« 

Tha last colunn. DL. givas tha status of the fila. 

Notice in Fig. 2 that fila 4<FIX4> has a D* This »ein* that 
tha fila has baan daleted fron tha directory* Sinca it tha 
first availabla "hole" tha next fila craatad will occupy its 
directory entry* 

Fila 3<MYPROG•BAS> has an L. Tha L indicatas that tha 
fila is locked* Also notica that filas 5-8 ara enpty 
directory entries. containing no directory entries* 


BS Trace Sactor Chain 


This nanu iten will varify tha structura of a fila. It 
tracas the fila through all of its sactors until it hits and 
of fila or a bad link* A link is a pointer to tha next sactor 
of a fila* A bad link is a link to a sactor that balongs to 
anothar fila« An and of fila is a link that points to the 
sactor 0« 

Fig*3 shows the sactor Chain for the snall BASIC fila 
MYPROG.BAS* Notice that wa are tracing file nunbar 3* Tha 
fila nunbar is tha entry nunbar into the directory. 
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The BS colunn has two different neanings» depending on 
the DOS that created the file. The 9/24 DOS A used this 
nunber as the relative sector nunber« For the first sector in 
s file this should be 1* Subsequent sectors should add 1 to 
this nunber« If aou notice that nunbers are skipped» this naa 
indicate that the links in sour file naa have becone bad« 

The last sectors BS is the nunber of bates in the sector» 

For DOS II the BS indicates the nunber of bates in each 
sector« Most sectors should contain 47D bates(128 bäte single 
densita disk) or *FD bates<256 bates double densita disk)* 

The last sector in a file is usualla less then the above 
nunbers« 

Appending one file to another will cause the bäte count 
in the sector inbetween the appended portions to be less then 
full ♦ It is therefore possible to have partialla filled 
sectors in the niddle of a file » 

The last cölunn» FP, is the forward pointer« This is the 
link to the next sector of the file. Files on newla fornatted 
diskettes tend to be linked sequentialla« Files on diskettes 
that have several files that have been deleted tend to becone 
"fractured". This neans that the files tend not to be 
sequentialla linked. In other words the sectors are not 
phasicalla contiguous« 


CJ Modifa Directora Entra 


You can use this nenu iten to nake changes to the 
diskettes directora« Enter the file nunber of the entra aou 
wish to change followed ba <RETURH>« 

Fig« 4 shows the user is naking a change to directora 
entra 3. FIX has printed the directora iten and positioned the 
Cursor to the filenane« 

At this point aou can edit the filenane« the starting 
sector nunber» the nunber of sectors» or the status of the 
file. Ba inserting or deleting the D aou can delete or 
"un-delete" the file. Ba adding or deleting the L aou can 
lock or unlock the file. See section III.A for the neaning of 
the rest of the info on the line* 

If aou wish to have FIX update the entra» then tape 
<RETURN>. If aou don't want the entra updated, then tape 
<BREAK>. 
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D« Check. Allocation Map 


This nenu iten can recover sectors that hav# becone 
nis-allocated» To run it type D« FIX autoMatically Start* 
naking it's own BIT MAP« It will link thru all th* files and 
Mark all the sectors in use and those that are free« FIX then 
coMpares it's BIT MAP to the BIT MAP on th# diskette« All 
sectors that should be free but aren't are printed as "MARKED 
IN USE”« All sectors that are really allocated to a file but 
aren't in th# diskettes BIT MAP are Marked "FREE"« Sectors 
that are correctly allocated are not printed* 

After FIX has checked all the sectors it will exit back 
to th# Menu if all sectors are correct« If sone sectors are 
nis-allocated it will ask you to if you want to write it's 
correct copy to the diskette» Just type "Y" to do so. If you 
don't want to write the corrected BIT MAP to be written .to th# 
disk then type <RETURN>« 

Fig« 5 shows the result of a D connand« Notice that we 
had a bad link in file OCthe first file). This will usually 
cause an error 16A when you attenpt to read th# file. We 
would probably want' to trace its sector chain CB connand) to 
find the bad link« 

Our bit nap seens to be slightly nangled also» so we 
would type Y to rewrite our new bit nap. 


EJ Modify Sector Link 


You nay have discovered that sone of your sector links 
have been altered incorrectly« This nenu iten allows you to 
change the links in th# sectors on the diskette« After you 
type E » FIX will pronpt you to enter th* sector nunber to 
nodify« Enter th* hex sector nunber followed by <RETURN> 

Fix then prints the sector link infornation fron th# 
sector on the diskette« FIX Position* th# Cursor on the line. 
Using the Cursor control keys» you can alter the file nunber 
this sector is allocated to» the nunber of bytes in this 
sector of the file» and the FORWARD POINTER« Typing an E to 
the right of th* FORWARD POINTER will Mark this sector as End 
of File. 

To teil FIX to write out the updated info to the sector 
sinply typ# <RETURN>« If you realize that you have nade an 
error in trying to nodify this sector» Position the Cursor 
below th# line and type <RETURN>* FIX will then re-display 
the line* Type <RETURN> to exit«. 
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See section III«B for nore info on the sector link 
display* 


Fi Set Drive Nunber 

This nenu iten sets the drive nunber* Tape the drive nunber 
<1-8) and <RETURN>* Fi«. 7 shows a user settin« the drive 
nunber to 1 (FIX defaults to drive 1 upon loadin«)* 


Ci Exit To Dos 


This iten causes a return to DOS* 
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IV. ERROR CODES AND RECOVERY 


ERROR * DESCRIPTION 

XXXXXXXXXXXXIXXXXXXXXXXXXXXXXXXIXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 


128 BREAK KEY ABORT 

This is caused by typ ins <BREAK>* 


129 IOCB ALREADY OPEN 

The IOCB is already open« 

Recovery« You can CLOSE the IOCB and re-OPEN it« You can 
use the current IOCB« You nay want to check and see why 
the IOCB is OPEN« 


130 NON EXISTENT DEVICE 

You have tried to access a device not in the handler table* 
ie« the device is undefined« The handler nay be loaded in 
nenory but not initialized« This error nay occur when 
trying to access the ATARI 850 without running the RS232 
AUTORUN•SYS file. 

Recover« Check your I/O connand for the correct device« Or 
load and initialize the correct handler« 


131 IOCB WRITE ONLY ERROR 

You have attenpted to read fron a file opened for write 
only« 

Recovery« Open the file for read or read/write (update 
node)« 


132 ILLEGAL HANDLER COMMAND 

This is an CIO error code« The connand code passed to the 
device handler is illegal« The connand is either <»2 or is 
a special connand to a handler that hasn't inplenented any 
special connands« 

Recovery! Check your XIO» or IOCB connand code for illegal 
connand code. 


133 DEVICE/FILE NOT OPEN 

Device or file not open« You have not OPENED this file or 
device« 

Recovery« Check your OPEN statenent or file I/O statenent 
for the wrong file specification« 
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INVALID IOCB NUMBER 

You have tried to use an illegal IOCB index« For BASIC» the 
ränge is 1-7« BASIC does not allow use of IOCB 0» The 
ASSEMBLER EDITOR Cartridge requires the IOCB index to be a 
multiple of 16 and lese than 128« 


IOCB WRITE ONLY ERROR 

You have tried to write to a device/file that is OPEN for 
read only« 

Recovery« You could open the file for write or read/write* 


END OF FILE 

Your input file is at end of file« No more data in file« 


TRUNCATED RECORD 

This error typically occurs when the record you are reading 
is larger then the maxinum record size specified in the 
call to CIO« BASIC's maxinum record size is 119 bytes« 
Recovery« You probably are trying to use an 
INPUT(Record-oriented) type command on a file that was 
created using PUT(byte-oriented) connands« 

Records in a file are delinited by E0L(End Of Line) 
characters <S9B)• Files that are created using PUTs have 
no EOL unless the bytes you output have a S9B« Trying to 
read a PUT file with record I/O may cause the DOS to read a 
record that is the size of the file« The DOS will then 
generate this error« Try reading the file using PUT type 
statenents « 

This error may also occur when ENTERing a BASIC 
program created using SAVE« Try LOADing the program« 


DEVICE TIMEOUT 

A command was sent by the Computer to a device device over 
the SERIAL BUS« The device did not respond within the 
period set by the 0« S« for that particular device command« 

This error can be caused in several ways« 

1« The device number may be wrong* 


Ex. OPEN #3 » 4»0»"D3!MYPROG" 


You would get this error if disk drive 3 was not connected 
to the Computer» not turned on» or not present. 

2« The disk drive may be present but is unable to execute 
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the comnand in the proper period of time* 

Recovery« To recover fron error case 1» exanine the 
connections between the disk drive and the Computer to make 
eure the are properly secured* Check the drive to make sure 
it is powered on and set for the correct drive nunber« You 
should check your I/O connand for the correct drive nunber* 
Retry the comnand* If you 9 et this error again see the next 
line* 


The second type of tineout error is caused by an 
interaction between the 0* S« and the disk drive* DOS 
9/24 / s tineout value was set too low for all possible cases 
of disk operations« The disk nay have had sone trouble 
executing the connnand in the short period allowed by the 
operating System* DOS II does not have this problen* 

The second type of tineout error is internitent. You 
should be able to retry the Operation and succeed» If this 
error occurs nore then a few tines» the device nay need 
repair* 


DEVICE NAH 

This error is a sort of catch all error code* The device 
nay have received a valid comnand but can't execute it 
because of bad Parameters* For exanple» trying to read an 
unaddressable sector» such as sector 0« The device nay have 
recieved a garbled connand or data frane fron the conputer» 
Recoveryi Check your I/O connand for illegal Parameters* 


SERIAL FRAME ERROR 

Bit 7 of SKSTAT in POKEY is set* This neans Communications 
fron the device to the conputer is garbled* Specifically* 
POKEY detected nissing or extra bits in a byte received on 
the SERIAL DATA BUS* 


CURSOR OUTRANGE 

Your Cursor is out of ränge for this particular graphics 
mode* 


SERIAL OVERRUN 

Bit 5 of SKSTAT in POKEY is set*The conputer did not 
respond fast enough to a SERIAL BUS input interupt« POKEY 
recieved another 8-bit word on the SERIAL BUS before the 
conputer could process the previous word received« 
Recovery* This is a rare error* If it recurs you should 
have your conputer serviced* 
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1-43 CHECKSUM ERROR 

Serial Bus connunications are screwed up* The checksun sent 
ba device is not th# sane as that calculated for frane 
received ba conputer. 

Recovera? Not nuch aou can do about this* Could be Hardware 
or sortware problen in device/conputer♦ 


144 DEVICE DONE ERROR 

The device is unable to execute a valid connand» There are 
two causes of this error. Usualla it neans aou have tried 
to write to a write protected device or diskette. This is 
easila corrected ba renovina the disk protect tab or 
turnina the write protect switch on the 815 off. 

The second reason for this error appears unknown at 
this point.The disk drive is unable to read/write the 
sector requested or the cassette is set at the .wrona baud 
rate. 

Recovera? Renove write protect tab or turn off write 
protect switch. Zf the disk was not write protected» aou 
naa have problens with the diskette nedia« Don't know how 
to recover on cassette. 


1-45 READ AFTER WRITE COMPARE ERROR 

. You have tried to open the SCREEN EDITOR with an illeaal 
araphics node nunber. 

Recovera? Check GRAPHICS node call or the AUX2 bäte in the 
I0C8. 


1-46 FUNCTION NOT IMPLEMENTED 

Function not inplenented in handler» ie. traina to PUT to 
the keaboard or issuina special connands to the keaboard. 
Recovera? Check I/O connand for riaht connand to correct 
device 


1-47 NOT ENOUGH RAM FOR SELECTED GRAPHICS MODE 

Insufficient RAM for araphics node selected. 

Recovera? Add nore nenora or use a snaller araphics node. 


160 DRIVE NUMBER ERROR 

You specified an out of ranae drive<not 1-8) or aou have 
not allocated a buffer for this drive. 

Recovera? Check aour file specification or bäte 1802 (6710)♦ 


161 T00 MANY OPEN FILES 

You don't have ana free sector buffers to use on another 
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file. 

Recovery! You nay have up to 8 open files* Check location 
1801 ($709) for the nunber of sector buffers allocated. 


162 DISK FULL 

You don't have any nore free sectors on this diskette* 
Occurs when writing to a full diskette* 

Recovery! Use a different diskette with free sectors* Use 
the D Option on FIX to see if you have any nis-allocated 
sectors* At present there is no way to recover fron this 
error during progran execution* 


163 FATAL SYSTEM I/O ERROR 

This error code neans that the file nanager has a bug in 
it« If you get this error then please report it to CUSTOMER 
SERVICE. 


164 FILE NUMBER MISMATCH 

The structure of the file is danaged* One of the file links 
points to a sector allocated to another file» 

Recovery* Use B and E FIX connands to fix up the file 
links* You can not recover fron this error during progran 
execution* 


165 FILENAME ERROR 

Your file specification has illegal characters in it* Legal 
characters are alphnunerics»*> and ?• 

Recovery* Check file specification and renove illegal 
characters« 


166 POINT DATA LENGTH 

The byte count in the point call was greater then 125 
(single density) or 253 (double density 
Recovery* Check POINT statenent paraneters* 


167 FILE LOCKED 

You tried to access a locked file* 
Recovery! Unlock file« 


168 DEVICE COMMAND INVALID 

Probably neans device didn't recognize connand* 
Recovery! ????? 


169 DIRECTORY FULL 


-10- 



FIX Reference Manual 1*0 


170 


171 


172 


173 


You don't have ans free entries in the directors* 
Recovery« See A and C FIX conwands* 


FILE NOT FOUND 

You have tried to access a file that doesn't exist in the 
diskettes directors* 

Recovers! Usualls Sou have nistspad the file spec* Look at 
the directors usina the DOS A connend for the correct nane« 


POINT INVALID 

You / ve probabls tried to POINT to a bste or record besond 
the end of the file* 

Recovers? Check size of file aeainst the POINT value* 


ILLEGAL APPEND 

You have tried to OPEN a DOS I file for append usin« DOS 
II« DOS II cannot append to DOS I files« 

Recovers! Cops the DOS I file to DOS II diskette usine DOS 
II. 


BAD SECTORS AT FORMAT 

The disk Controller detected bad sectors while FORMAT'ine a 
diskette* 

Recovers! Throw awas the diskette and use another* If sou 
caanot FORMAT a diskette, the disk drive «es need repair. 
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